home *** CD-ROM | disk | FTP | other *** search
/ PC Graphics Unleashed / PC Graphics Unleashed.iso / xa / readme.txt < prev    next >
Text File  |  1994-07-26  |  5KB  |  118 lines
  1.         README.TXT for VSA256 Graphics Library Version 3.0    
  2.                    7-26-94
  3.  
  4. -------------------- FILES IN VSA256.ZIP DISTRIBUTION -----------------
  5.  
  6.     The distribution of the VSA256 Graphics Library Version 3.0
  7. consists of the 13 files listed below.  These files are archived in the
  8. file VSA256.ZIP.  To extract, just type 'PKUNZIP VSA256' in the
  9. directory that you want the files extracted to.
  10.  
  11. VSA_DEMO.C         VSA256 Demonstration program (Source Code).
  12. VSA_DEMO.EXE       VSA256 Demonstration program (Executable).
  13. VSA256MS.LIB       VSA256 Graphics Library (Microsoft C compatible).
  14. VSA256BC.LIB       VSA256 Graphics Library (Borland C Compatible).
  15. VSA.H              VSA256 Include file required in your program.
  16. VSA_FONT.H         VSA256 Include file required in your program.
  17. VSA_DEMO.MAK       Make File for Microsoft Quick C V2.5 (IDE).
  18. VSA_DEMO.PRJ       Project file for Borland C/C++ V3.1 (IDE).
  19. VSA_DEMO.IDE       Project file for Borland C/C++ V4.0 (IDE).
  20. VSA256.TXT         The VSA256 Users Manual.
  21. ORDER.TXT          A text file order form for registration and upgrades.
  22. README.TXT         This Document
  23. DRIVERS2.EXE       A self extracting archive of VESA BIOS TSRs.
  24.  
  25.  
  26. -------------- WHATS NEW IN VSA256 GRAPHICS LIBRARY V3.0 --------------
  27.  
  28. - Added Viewport Clipping to all drawing functions.
  29. - Added BitBLT drawing functions.
  30. - Added Vector Text: Infinitely scalable, positionable to nearest
  31.   pixel, fonts are fully user definable!                                   
  32. - Now works with Small, Medium, Compact Large memory
  33.   models with Borland (Already did so with Microsoft).
  34. - Fixed "unresolved external _fstrlen" linker error with Turbo C.
  35. - Fixed "Text I/O Functions Not Supported" problem.                   
  36. - Made all functions in VSA.H external, no more "Multiple
  37.   Declaration" warnings.
  38. - New routine, vsa_set_clip_mode.
  39. - New routine, vsa_set_viewport.
  40. - New routine, vsa_image_size.
  41. - New routine, vsa_get_image.
  42. - New routine, vsa_put_image.
  43. - New routine, vsa_get_pixel.   
  44. - New routine, vsa_get_text_cursor.
  45. - New routine, vsa_set_text_scale.
  46. - New routine, vsa_wait_vsync.
  47.  
  48. -------------- Compatibility With Previous VSA256 Version -------------
  49.  
  50.   VSA256 text support has been REVAMPED!  I no longer rely on the 
  51. video card manufacturers BIOS to get text support.  Instead I draw
  52. each character using 2D vector strokes.  The advantages are as follows:
  53.  
  54.         - Text now works with ALL video cards!
  55.         - Now text is Infinitely scaleable.
  56.         - Text positioning resolution is down to 1 pixel.
  57.         - Background color is preserved.
  58.         - The programmer can define his own fonts in VSA_FONT.H.
  59.  
  60.   Some minor incompatibilities with VSA256 version 2.0 were introduced 
  61. due to the changes and they are as follows:
  62.  
  63. -  vsa_write_string now takes x,y (in pixel coordinates) instead of 
  64.    row,col (in character coordinates) as the first two parameters.
  65. -  The first two parameters of vsa_write_string (x,y) are now int
  66.    instead of unsigned char.
  67. -  The vsa_write_char function was deleted.
  68. -  The supported ASCII characters are the printable characters 
  69.    from ASCII code 32 to ASCII code 127.
  70.  
  71.   Your existing code should take very little editing to make these
  72. changes, especially if you write a macro to edit all occurances of
  73. vsa_write_string as follows:
  74.  
  75. OLD - vsa_write_string(row,col,color,text);
  76.  
  77. NEW - vsa_write_string(col*XCharSize,row*YCharSize,color,text);
  78.  
  79.  
  80. ---------------- INSTALLING VESA BIOS EXTENSION DRIVERS ---------------
  81.  
  82. DRIVERS2.EXE is a self extracting archive file which contains the 
  83. VESA BIOS Extensions.  When executed, it will create subdirectories for 
  84. each of the video adapter manufacturers.  Within each subdirectory, it
  85. will place the respective VESA driver.  To execute:
  86.  
  87.       1. Get into the directory where you want the subdirectories 
  88.      to be created.
  89.       
  90.       2. Copy the file DRIVERS2.EXE into this directory.
  91.       
  92.       3. type drivers2 -d  (the -d tells it to create subdirectories).
  93.  
  94. --------------------------- Trouble Shooting --------------------------
  95.  
  96. 1.) Please read the VSA256.TXT document, at least sections 1 and 2, to
  97.     make sure you are setting things up right.
  98.  
  99. 2.) If Turbo C says "Undefined Symbol ___brklvl in module vsa_all0",
  100.     add the following line to the top of your main program file:
  101.     
  102.     unsigned __brklvl;
  103.  
  104. 3.) Tell me if there are any unresolved problems.
  105.  
  106.  
  107. ------------------------- Assist for 3 Compilers ----------------------
  108.     
  109. To help get you started, I have provided the "project" files for three 
  110. different compiler Integrated Development Environments (IDEs).  
  111.  
  112. Microsoft Quick C, Version 2.5  ----> VSA_DEMO.MAK
  113. Borland C/C++, Version 3.1      ----> VSA_DEMO.PRJ
  114. Borland C/C++, Version 4.0      ----> VSA_DEMO.IDE
  115.  
  116. Get in the respective IDE and just select/load the appropriate project
  117. file for your compiler.
  118.